wtp_ru

Edit 4 …

Eclipse Web Tools Platform

В данном руководстве мы расскажем, как настроить WTP для запуска и отладки приложений OpenXava внутри среды Eclipse.
Eclipse Web Tools Platform (WTP) - это проект Eclipse, предназначенный для разработки web и J2EE приложений.
Вы можете использовать WTP для запуска Tomcat (или другого сервера приложений) из Eclipse. При этом WTP позволяет сразу увидеть результаты ваши изменений без необходимости повторного развертывания вашего приложения на сервере приложений. Также вы сможете отлаживать ваш код с помощью отладчика.
Приложения OpenXava, создаваемые с помощью OpenXavaTemplate, изначально совместимы с WTP.
В данном руководстве мы будем использовать учебное приложение MySchool, которое поставляется вместе с OpenXava.

Настройка среды выполнения Tomcat для запуска в Eclipse

  • Перейдите Windows > Preferences > Server > Installed Runtimes.
  • Нажмите Add.
  • Выберите Apache > Apache Tomcat 5.5.
  • Далее нажмите Next.
  • Заполните поля формы:
    • Name: Apache Tomcat v5.5
    • Tomcat installation directory: Каталог, где установлен Tomcat (вы можете использовать Tomcat, поставляемый вместе с OpenXava, он расположен в дочерней папке tomcat папки, где развернута OpenXava)
    • JRE: Выберите Java 5.
  • Нажмите Finish.
  • Нажмите OK в диалоге Preferences Dialog, форма закроется.
Предупреждение! Если вы не используете Tomcat, который поставляется с дистрибутивом OpenXava, вам необходимо скопировать jta.jar и ejb.jar из openxava-3.0.x/tomcat/common/lib в папку common/lib вашего сервера Tomcat.

Настройка сервера Tomcat в Eclipse

  • Перейдите на закладку Server. Если такой не существует, добавьте её (Windows > Show view > Other > Server > Servers).
  • На закладке Server нажмите Right Button > New > Server.
  • Выберите в качестве среды выполнения Server runtime: Apache Tomcat v5.5.
  • Нажмите Next.
  • Добавьте MySchool в Configured projects (сконфигурированные проекты).
  • Нажмите Finish.

Определение источников данных (data sources)

После выполнения вышеуказанных действий в вашем workspace появился проект Servers. Внутри данного проекта вы увидите папку Tomcat v5.5 Server @ localhost-config. Создайте там файл context.xml со следующим содержимым:
<!-- The contents of this file will be loaded for each web application -->
<Context>
 
<!-- Default set of monitored resources -->
<WatchedResource>WEB-INF/web.xml</WatchedResource>
 
<!-- Uncomment this to disable session persistence across Tomcat restarts -->
<Manager pathname="" />
 
<Resource name="jdbc/OpenXavaDS" auth="Container" type="javax.sql.DataSource"
maxActive="20" maxIdle="5" maxWait="10000"
username="sa" password="" driverClassName="org.hsqldb.jdbcDriver"
url="jdbc:hsqldb:file:/java/openxava-3.0/tomcat/data/openxava-db"/>
 
<Resource name="jdbc/MySchoolDS" auth="Container" type="javax.sql.DataSource"
maxActive="20" maxIdle="5" maxWait="10000"
username="sa" password="" driverClassName="org.hsqldb.jdbcDriver"
url="jdbc:hsqldb:file:/java/openxava-3.0/tomcat/data/my-school-db"/>
 
</Context>
 

Не забудьте вместо /java/openxava-3.0 указать путь на папку, где у вас установлена OpenXava.

Запуск сервера и тестирование приложения

  • Остановить OpenXava Portal (stop-portal.sh/.bat), если у вас был запущен OpenXava.
  • Перейдите на закладку Server.
  • Нажмите Right Button on Tomcat v5.5 Server > Start
  • Подождите, пока запустится Tomcat.
  • Запустите интернет-браузер и перейдите по адресу http://localhost:8080/MySchool/xava/module.jsp?application=MySchool&module=Teacher

Разработка с использованием WTP

После выполнения вышеперечисленных шагов, если вы вносили изменения в код Java, то необходимо выполнить полную сборку Build All (или Ctrl-B). Сразу за этим вы можете увидите в интернет-браузером измененное приложение. Если вы меняли файлы XML, вам необходимо выполнить ant-цель rebuild , синхронизировать ваш проект Eclipse с файловой системой (F5 Refresh), теперь можно смотреть результаты в браузером.

Теперь, кроме всего вышеперечисленного, вы можете запустить Tomcat в режиме отладки, используя встроенный отладчик Eclipse.